@vint.tri/report_gen_mcp 1.7.28 → 1.7.29

package/ULTIMATE_INSTRUCTIONS.md

@@ -0,0 +1,76 @@
+# Главная инструкция по работе с инструментом report_gen_mcp
+
+**ЦЕЛЬ:** Генерация качественных, визуально насыщенных HTML-отчетов по запросу пользователя.
+
+**КЛЮЧЕВОЕ ПРАВИЛО:** При любом запросе, связанном с отчетами, диаграммами или графиками, **всегда используй инструмент `report_gen_mcp`**. Не пытайся отвечать текстом или генерировать отчеты самостоятельно.
+
+---
+
+### **АЛГОРИТМ ДЕЙСТВИЙ**
+
+**Шаг 1: Определи суть запроса**
+- Пойми, о чем пользователь хочет получить отчет (например, "финансовые показатели Apple", "сравнение акций Tesla и Google").
+
+**Шаг 2: Спланируй визуальные элементы**
+- Придумай **1-2 диаграммы** и **1 изображение**, которые хорошо проиллюстрируют тему отчета.
+- Для каждой диаграммы определи тип (`bar`, `line`, `pie` и т.д.) и данные.
+- Для изображения придумай текстовый промпт для генерации.
+
+**Шаг 3: Подготовь параметры для вызова инструмента**
+- **`document` (string):** Напиши текст отчета в формате Markdown. Вставь в него плейсхолдеры для визуальных элементов, например: `[[chart:sales_chart]]` и `[[image:cover_image]]`.
+- **`elements` (object):** Создай **ОБЪЕКТ**, где ключи — это названия твоих плейсхолдеров, а значения — это конфигурации для их генерации.
+- **`outputFile` (string):** Придумай понятное имя для HTML-файла, например `apple_report_2024.html`.
+
+**Шаг 4: Сформируй `elements` ПРАВИЛЬНО (КРИТИЧЕСКИ ВАЖНО!)**
+
+- **`elements` — это ОБЪЕКТ, а не строка!**
+- **Для диаграмм:**
+  - `labels`, `data`, `backgroundColor`, `borderColor` — **ВСЕГДА МАССИВЫ**, даже для одного значения.
+    - `labels`: `["Q1", "Q2"]`
+    - `data`: `[100, 150]`
+    - `backgroundColor`: `["#FF6384", "#36A2EB"]`
+  - `options.title`: **ВСЕГДА СТРОКА**. `"Продажи по кварталам"`
+- **Для изображений:**
+  - Используй `type: "pollinations"` и `config: { prompt: "..." }`.
+
+---
+
+### **ИДЕАЛЬНЫЙ ПРИМЕР ВЫЗОВА**
+
+```json
+{
+  "method": "generate-report",
+  "params": {
+    "document": "# Отчет о продажах\n\nАнализ квартальных продаж.\n\n[[chart:sales]]\n\nИзображение, отражающее успех:\n\n[[image:success_image]]",
+    "elements": {
+      "sales": {
+        "type": "bar",
+        "config": {
+          "labels": ["Q1", "Q2", "Q3", "Q4"],
+          "datasets": [{
+            "label": "Продажи 2024",
+            "data": [120, 150, 130, 180],
+            "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0"]
+          }],
+          "options": {
+            "title": "Квартальные продажи"
+          }
+        }
+      },
+      "success_image": {
+        "type": "pollinations",
+        "config": {
+          "prompt": "business growth and financial success chart"
+        }
+      }
+    },
+    "outputFile": "sales_report_2024.html"
+  }
+}
+```
+
+---
+
+### **Что делать после вызова?**
+
+Инструмент вернет путь к файлу. Ты должен показать его пользователю вместе со ссылками для просмотра.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA0fA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsgBA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCjD"}

package/dist/index.js

@@ -103,7 +103,7 @@ if (process.argv.length === 2) {
     // No command specified, run in stdio mode using MCP SDK
     const mcpServer = new McpServer({
         name: "report_gen_mcp",
-        version: "1.7.28"
+        version: "1.7.29"
     }, {
         // Disable health check to prevent automatic calls
         capabilities: {
@@ -182,19 +182,26 @@ if (process.argv.length === 2) {
             tempDirectory: z.string().optional().describe("Temporary directory for file storage (optional, will use REPORTS_DIR environment variable if set)"),
         },
     }, async (params) => {
-        // Handle case where arguments might be sent as a JSON string by Claude desktop
+        // --- НАЧАЛО БЛОКА НАДЕЖНОЙ ОБРАБОТКИ ПАРАМЕТРОВ ---
         let processedParams = params;
-        if (typeof params === 'string') {
-            try {
-                processedParams = JSON.parse(params);
+        try {
+            // Если параметры - это строка, парсим ее как JSON
+            if (typeof processedParams === 'string') {
+                processedParams = JSON.parse(processedParams);
             }
-            catch (parseError) {
-                throw new Error('Invalid JSON string in arguments');
+            // Если есть вложенный объект `arguments`, используем его
+            if (processedParams.arguments && typeof processedParams.arguments === 'object') {
+                processedParams = processedParams.arguments;
+            }
+            // Если `elements` - это строка, парсим и ее
+            if (processedParams.elements && typeof processedParams.elements === 'string') {
+                processedParams.elements = JSON.parse(processedParams.elements);
             }
         }
-        else if (params.arguments && typeof params.arguments === 'object') {
-            processedParams = params.arguments;
+        catch (e) {
+            throw new Error('Invalid JSON format in parameters. Ensure all parameters, especially "elements", are valid JSON.');
         }
+        // --- КОНЕЦ БЛОКА НАДЕЖНОЙ ОБРАБОТКИ ПАРАМЕТРОВ ---
         // Extract parameters correctly, ensuring outputFile is not nested within elements
         const { document, elements, charts, outputFile = 'report.html', tempDirectory } = processedParams;
         // Поддержка обратной совместимости: если переданы charts, используем их как elements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vint.tri/report_gen_mcp",
-  "version": "1.7.28",
+  "version": "1.7.29",
   "description": "CLI tool for generating HTML reports with embedded charts and images",
   "main": "dist/index.js",
   "bin": {

package/NEURAL_NETWORK_INSTRUCTIONS.md

@@ -1,81 +0,0 @@
-# Финальные инструкции для нейросети по работе с инструментом report_gen_mcp v1.8.0
-
-**ВАЖНО:** ВСЕГДА ИСПОЛЬЗУЙТЕ ИНСТРУМЕНТ `report_gen_mcp` КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ЗАПРАШИВАЕТ СОЗДАНИЕ ОТЧЕТА, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК ИЛИ ЛЮБОЕ ИЗМЕНЕНИЕ СУЩЕСТВУЮЩЕГО ОТЧЕТА!
-
-## 1. Обязательное использование инструмента
-
-**КЛЮЧЕВОЕ ПРАВИЛО:** При любом запросе пользователя, связанном с созданием или изменением отчетов, диаграмм или графиков, вы **обязаны** использовать инструмент `report_gen_mcp`. Не пытайтесь создавать отчеты вручную.
-
-## 2. Требования к качеству отчетов
-
-Каждый сгенерированный отчет должен быть:
-- **Информативным:** Содержать анализ данных, выводы и рекомендации.
-- **Визуально насыщенным:** Включать **как минимум одну диаграмму и одно изображение**, релевантные теме отчета.
-- **Красиво оформленным:** Использовать заголовки, списки и выделение текста для лучшей читаемости.
-
-## 3. Работа с файлами
-
-- **Сохранение:** Все отчеты автоматически сохраняются в **системную временную директорию**. Вам не нужно указывать полный путь — только имя файла в параметре `outputFile`.
-- **Возврат данных:** Инструмент вернет вам полный путь к созданному файлу, который вы должны предоставить пользователю вместе со ссылками для просмотра.
-
-## 4. Формат параметров (КРИТИЧЕСКИ ВАЖНО!)
-
-### 4.1. Параметр `elements`
-
-- `elements` **ВСЕГДА** должен быть **ОБЪЕКТОМ**, а не строкой.
-
-  - ❌ **НЕПРАВИЛЬНО:** `"elements": "{...}"`
-  - ✅ **ПРАВИЛЬНО:** `"elements": {...}`
-
-### 4.2. Параметры диаграмм (`charts`)
-
-- **Массивы, массивы и еще раз массивы!**
-  - `labels`: **ВСЕГДА** массив строк. `["Январь"]`
-  - `data`: **ВСЕГДА** массив чисел. `[100]`
-  - `backgroundColor`: **ВСЕГДА** массив строк. `["red"]`
-  - `borderColor`: **ВСЕГДА** массив строк. `["blue"]`
-- `options.title`: **ВСЕГДА** простая строка. `"Мой график"`
-
-**Примечание:** Система теперь пытается автоматически исправлять некоторые ошибки форматирования (например, одиночные значения в массивы или парсинг строки `elements`), но для гарантированной работы **всегда** придерживайтесь правильного формата.
-
-## 5. Пример идеального вызова
-
-```json
-{
-  "method": "generate-report",
-  "params": {
-    "document": "# Отчет о продажах\n\nАнализ квартальных продаж.\n\n[[chart:sales]]\n\n![бизнес-успех]([[image:success]])",
-    "elements": {
-      "sales": {
-        "type": "bar",
-        "config": {
-          "labels": ["Q1", "Q2", "Q3", "Q4"],
-          "datasets": [{
-            "label": "Продажи 2024",
-            "data": [120, 150, 130, 180],
-            "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0"]
-          }],
-          "options": {
-            "title": "Квартальные продажи"
-          }
-        }
-      },
-      "success": {
-        "type": "pollinations",
-        "config": {
-          "prompt": "график роста и успеха в бизнесе"
-        }
-      }
-    },
-    "outputFile": "sales_report.html"
-  }
-}
-```
-
-## 6. Ответ пользователю
-
-После успешной генерации отчета предоставьте пользователю:
-1.  **Путь к файлу** (из ответа инструмента).
-2.  **Ссылку `file://`** для локального открытия.
-3.  **Ссылку `http://localhost:3000/...`** (Web link 2) для надежного отображения всех элементов.
-4.  **Полное содержимое HTML-файла**.